home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 1 / LSD Compendium Deluxe 1.iso / a / programming / c / dicepj20.lha / diceproject / Project_FR.doc < prev    next >
Encoding:
Text File  |  1993-10-31  |  17.9 KB  |  605 lines
  1.  
  2.     Documentation Project Handler 2.0
  3.     =================================
  4.  
  5.        par Cedric Counotte
  6.  
  7.  
  8. 'Introduction'
  9.  
  10. 'Installation rapide'
  11.  
  12. 'Détails sur l'installation'
  13.  
  14. 'Comment s'enregistrer'
  15.  
  16. 'Copyright'
  17.  
  18. Les nouveautés :
  19.     La 'Localisation'
  20.     Un 'aide' en ligne.
  21.     La 'gestion' des autodocs de Commodore®.
  22.     Le multitâche des 'fenêtres'.
  23.  
  24. Les outils :
  25.     La 'recherche' des fichiers inclus à l'intérieure d'un source.
  26.  
  27. Tour d'horizon de l'interface graphique
  28.     Utilisation de l'interface au 'clavier'
  29.     'Particularité' de l'utilisation au clavier
  30.     Utilisation des 'fenêtres'
  31.     Utilisation du 'menu'
  32.  
  33. 'Bugs connus'
  34.  
  35. 'Remerciements'
  36.  
  37. 'Contacter l'auteur'
  38.  
  39.  
  40.     Introduction
  41.     ============
  42.  
  43. Project Handler est une interface pour le compilateur DICE© de mattew dillon,
  44. dans le style de Turbo C© de Borland sur PC.
  45.  
  46. Ce gestionnaire ne fonctionne que sous système 2.0 ou plus, et prend les
  47. avantages du 2.1 et du 3.0 quand cela est possible.
  48.  
  49. Il est entièrement 'localisé', fourni en français et en anglais.
  50. Si vous traduisez le catalogue fourni également, envoyez-le, je l'inclurais dans les
  51. prochaines version.
  52.  
  53. Un 'aide en ligne' permet de prendre en main le gestionnaire
  54. rapidement grâce à la bibliothèque amigaguide du 3.0 ou celle présente sur BBS et
  55. dans le domaine publique.
  56.  
  57. Project Handler est 'propriété' de Cedric Counotte résident en France (Paris).
  58.  
  59.  
  60.     Installation rapide
  61.     ===================
  62.  
  63. C'est extrêmement simple, vous copiez le programme Project ou Project030, là où
  64. vous le désirez, puis vous le lancez.
  65.  
  66. Avant de pouvoir travaillez, il vous faut changer certaines options dans le
  67. menu 'Préférences' comme :
  68.     - 'Générales'
  69.     - 'Répertoires'
  70.     - Editeur toujours dans le menu Préférences.
  71.  
  72. Et voilà, c'est tout, le gestionnaire est prêt à se soumettre à vos ordres!
  73.  
  74.  
  75.     Détails sur l'installation
  76.     ==========================
  77.  
  78. Quels sont les fichiers important ?
  79.  
  80.     - Project_??.guide à mettre dans Help:français où au côté du programme
  81.     +Changer le nom en project.guide.
  82.  
  83.     - project.prefs dans ENV: et ENVARC: conservant les préférences initiales.
  84.     NB : Chaque projet possède ses propres 'préférences'.
  85.  
  86.  
  87. Quels sont les options importantes ?
  88.  
  89.     - Les options de compilation/édition de lien, cf dcc.doc.
  90.  
  91.     - Les options des 'répertoires' utilisée pour accéder
  92.     aux bibliothèques de DICE, aux fichiers à inclure, ainsi qu'aux 'autodocs'.
  93.  
  94.     - L'options editeur du menu 'Préférences' pour choisir avec quel
  95.     éditeur travailler.
  96.  
  97. Quels sont les dispositions par rapport à DICE ?
  98.  
  99.     - Le répertoire bin doit exister et contenir das, dc1, dcc, dccpp et libmake.
  100.  
  101.     - Vous devez spécifier le répertoire père de bin comme répertoires DICE dans la
  102.     fenêtre 'Répertoires'.
  103.  
  104.     - Si vous avez placé dans la startup-sequence, des assigns pour DICE,
  105.     vous pouvez maintenant les enlever, le gestionnaire s'en occupe pour vous.
  106.  
  107.  
  108.  
  109.     Comment s'enregistrer
  110.     =====================
  111.  
  112. Simple, envoyez-moi une carte postal avec votre nom, prénom, age, sexe,
  113. travail actuel, ville et pays ( Et oui! tout ça! ).
  114.  
  115. Si vous possédez une adresse électronique n'hesitez pas non plus à me la communiquer.
  116.  
  117. Remarque : Tous les renseignements que vous donnerez resteront privés, et
  118. ouvert à vos corrections.
  119.  
  120. Toutes les contributions seront les bienvenues et même appréciées, elles restent toutefois
  121. facultatives mais vous donne droit à une mise à jour gratuite sur disquette pour une somme
  122. minimum de 50Fr (c'est peu).
  123.  
  124.  
  125.     Copyright
  126.     =========
  127.  
  128. Copyright (C) 1993 Cedric Counotte
  129.  
  130.     Aucune garantie de quelque nature n'est donnée sur le fonctionnement
  131.     du programme décrit dans ce document. Vous utilisez ce matériel à
  132.     vos propres risques. L'auteur ne peut pas être rendu pour
  133.     responsable des dommages causés par l'utilisation de ce
  134.     programme.
  135.  
  136.     Ni le programme, ni le code source ne peuvent être utilisés sans la
  137.     permission express de l'auteur à des fin commerciales autres que le
  138.     domaine public.
  139.  
  140.  
  141.     La Localisation
  142.     ===============
  143.  
  144. La localisation a pris pas mal de temps, mais voila, elle est là, fourni
  145. avec le catalogue, vous pouvez donc le traduire dans une autre langue.
  146.  
  147. Cette nouvelle options est disponible uniquement avec le système 2.1 et supérieur.
  148.  
  149.  
  150.     Aide en ligne
  151.     =============
  152.  
  153. L'aide en ligne est réservé au heureux possesseurs de la bibliothèque
  154. amigaguide.library.
  155.  
  156. La touche Help permet dans toutes les fenêtres, d'accéder suivant le
  157. contexte à un des noeuds de project.guide.
  158.  
  159. Le guide est visualisé par un autre processus, il fonctionne donc en
  160. parallèle au gestionnaire.
  161.  
  162.  
  163.  
  164.     Autodocs de Commodore®
  165.     ======================
  166.  
  167. Si vous possèdez les autodocs de commodore, traduite en guide, vous pouvez les
  168. appelez directement du programme, pour ce faire, il suffit de spécifié le
  169. répertoires où les guides sont stockés dans la fenêtre 'Répertoires'.
  170.  
  171.     Recherche des fichiers inclus
  172.     =============================
  173.  
  174. Lorsque la sélection de la fenêtre 'principale' est un fichier
  175. .c ou .a, une recherche recursive est faites sur ce fichier. Une liste
  176. est ensuite affiché, vous pouvez ainsi visualisé/éditer le fichier
  177. de votre choix.
  178.  
  179. Pour utiliser la liste de sélection au clavier, référez-vous à la manipulation
  180. 'particulières' de ces listes.
  181.  
  182.  
  183.     Utilisation de l'interface au clavier
  184.     =====================================
  185.  
  186. Tout le gestionnaire est utilisable au clavier, les racourcis standards
  187. pour le menu, et les racourcis des mots soulignés dans les fenêtre.
  188.  
  189. Toutefois, quelques 'particularité' apparaissent quand
  190. à l'utilisation des listes de vues de la 'fenêtre principale', de
  191. la fenêtre des 'messages', de la liste de sélection lors de la
  192. 'recherche' des fichiers inclus, et de la liste des modes vidéo de
  193. la fenêtre 'Options Ecran'.
  194.  
  195.  
  196.     Particularité de l'utilisation au clavier
  197.     =========================================
  198.  
  199. L'utilisation au 'clavier' est mise en place comme
  200. le décrit Commodore, grâce à la bibliothèque gadtools.library.
  201.  
  202. Seules les listes de vues ne sont pas gérées de façon standard.
  203.  
  204. Comme, chaque liste apparait seule dans une fenêtre, les touches de
  205. direction haut et bas permettent de déplacer la sélection dans la liste,
  206. la touche return permettant quand à elle de valider la sélection :
  207.     - Commande Edition du menu 'Objets' pour la 'fenêtre principale'.
  208.     - Rien pour la liste des messages et la liste des modes vidéo.
  209.     - Visualisation/edition de la sélection pour les listes de sélection.
  210.  
  211. De plus, tous les lettres non utilisées par des gadgets, permettent
  212. d'obtenir le premier élément commençant par cette lettre si il
  213. existe.
  214.  
  215.  
  216.     L'utilisation des fenêtres
  217.     ==========================
  218.  
  219. Le gestionnaire DICE comporte de nombreuses fenêtres pouvant être contrôlée au 'Clavier'
  220. ou à la souris.
  221.  
  222. Concernant l'utilisation au clavier, la fenêtres principale, celle des 'messages' et les listes de vues
  223. possèdent quelques 'Particularités'
  224.  
  225. Toutes les fenêtres fonctionnent en multitache sauf celle de compilation, c'est à dire qu'elle peuvent
  226. être affiché et utilisée en même temps.
  227.  
  228. De plus, pour les heureux possésseurs du Système 3.0, toutes les fenêtres possède
  229. le même 'menu' que la 'fenêtre principale'.
  230.  
  231.     Déscription des différentes fenêtres:
  232.     'Sources'
  233.     'Messages'
  234.     'Ligne de paramètres'
  235.     'Compilation'
  236.     'Options Principales'
  237.     'Options Compilateur'
  238.     'Options Editeur de liens'
  239.     'Options répertoire'
  240.     'Options Ecran'
  241.     'Options Palette'
  242.  
  243.  
  244.     Fenêtres des Sources
  245.     ====================
  246.  
  247. Cette fenêtre est la fenêtre principale du gestionnaire, elle contient la liste des fichiers à
  248. inclure lors de la compilation et/ou de l'édition des liens.
  249.  
  250. Les types reconnus à l'heure actuel sont :
  251.     - Fichier assembleur    .a        (non testé)
  252.     - Fichier sources C     .c
  253.     - Fichier objets        .o
  254.     - Bibliothèques        .lib
  255.  
  256.  
  257. En plus du nom du fichier, la liste comporte les informations suivantes :
  258.     - Taille en octets du fichier sources C ou assembleur.
  259.     - Taille en octets du fichier objets généré.
  260.     - Présence ou non de commentaires sur cette élément.
  261.  
  262. Il est à noter que le nom du fichier et précédé du chemin d'accés au cas où le fichier spécifié
  263. ne soit pas dans le répertoire source défini dans le fenêtre 'Options Répertoire'.
  264.  
  265.  
  266. Un double clique sur un élément de la liste appel automatiquement l'éditeur choisi dans le
  267. menu 'Préférences'.
  268.  
  269.  
  270. Le 'Menu' vous permets de contrôler l'interface et le compilateur. Ce même menu
  271. est rattaché à la fenêtres des 'messages'.
  272.  
  273.  
  274.     Fenêtres des Messages
  275.     =====================
  276.  
  277. Cette fenêtre contiendra les erreurs lors de la compilation et de l'édition des liens.
  278.  
  279. Elle peut être également contrôlé avec le 'clavier' à partir de la 'fenêtre principale'.
  280.  
  281.  
  282.     Fenêtres Lignes de paramètres
  283.     =============================
  284.  
  285. Elle vous permet de spécifier la ligne de commande à utilisé lors du lancement du
  286. programme à partir du CLI dans le menu 'Executable'.
  287.  
  288. Attention toutefois, aucune fenêtre DOS de sortie n'est spécifié lors du lancement,
  289. un moyen d'y pallier est de rediriger la sortie sur un fichier en ajouttant à la
  290. ligne de paramètres : >'Nom du fichier'.
  291.  
  292.  
  293.     Fenêtres de compilation
  294.     =======================
  295.  
  296. Cette fenêtre apparaît lorsque que les commandes du menu 'Executable' suivantes sont executées :
  297.     - Créer Objet Final
  298.     - Compiler
  299.     - Compiler Tout
  300.  
  301.  
  302. Elles permettent respectivement de :
  303.  
  304.     - Compiler les sources C et assembleur, puis de créer l'executable ou la
  305.   bibliothèque suivant le type de l'objet final défini dans la fenêtre des
  306.   'Options Principales'.
  307.  
  308.     - Compiler les sources C et assembler si nécessaire suivants les
  309.   dépendances de chaque fichier déterminé dynamiquement.
  310.     Cette commande execute dans certaines circomstances la commande suivante
  311.   lorsque cela semble nécessaire. Généralement aprés avoir modifié les
  312.  
  313.   'Préférences'.
  314.     - Recompiler toutes les sources.
  315.  
  316. Pour plus d'information sur ces commandes, reporté vous au menu 'Executable'?
  317.  
  318.  
  319.     Fenêtres des Options Principales
  320.     ================================
  321.  
  322. Dans cette fenêtre, vous pouvez choisir le type de l'objet générer par le
  323. gestionnaire, à savoir :
  324.     - Un executable Amiga®
  325.     - Une bibliothèque pour DICE
  326.     - Un fichier à implanter sur EPROM ( pas encore ! )
  327.  
  328. Les deux ascenseurs permettent de déterminer pour qu'elle version du
  329. système d'exploitation, l'objet serat créer.
  330. Entre les deux ascenseurs se trouvent le numéro de version sous la forme x.y .
  331. Il en résulte que les fichiers inclus de la bibliothèque Amiga® seront cherchés
  332. en priorité dans DINCLUDE:amigaxy, et que cette même bibliothèque portera le
  333. nom de amigaxy??.lib.
  334.  
  335. Si vous cliqué sur Utiliser après avoir modifié des options dans cette fenêtre,
  336. les sources seront entièrement recompiler.
  337.  
  338.  
  339.     Fenêtres des Options de Compilation
  340.     ===================================
  341.  
  342. Pour plus d'information sur les différentes options de compilation, reportez-vous
  343. aux docs du DICE.
  344.  
  345.  
  346.     Fenêtres des Options d'édition de liens
  347.     =======================================
  348.  
  349. Pour plus d'information sur les différentes options d'édition des liens,
  350. reportez-vous aux docs de DICE.
  351.  
  352.  
  353.     Fenêtres des Répertoires
  354.     ========================
  355.  
  356. Dans cette fenêtre, vous spécifiez l'ensemble des chemin d'accés des
  357. différents fichiers possible :
  358.  
  359.     - Source : Où se trouvent les sources, et où allez les chercher
  360.     en priorité.
  361.  
  362.     - Destination : Dans quel répertoires serat créé le programme
  363.     executable ou la bibliothèque.
  364.  
  365.     - Inclus : Chemin d'accés des fichiers .h inclus du C.
  366.  
  367.     - Bibliothèques : Chemin d'accés des fichier .lib.
  368.  
  369.     - Objets : Répertoires où stocker les fichier génerer (.o).
  370.  
  371.     - DICE : Chemin de base de DICE dans lequel doit se trouvé le
  372.     sous-répertoires bin avec dcc, dcpp, dc1, ...
  373.  
  374.     - Autodocs : Chemin d'accés des 'autodocs' Commodore© sous
  375.     forme de guides.
  376.  
  377.  
  378.  
  379.     Fenêtres des Options de l'écran
  380.     ===============================
  381.  
  382. De gauche à droite et de haut en bas, vous trouvez les champs suivants :
  383.  
  384.     - Type d'écrans    : Permet de choisir si l'interface s'ouvre
  385.                   sur un nouvel écran, où si elle utilise
  386.                   l'écran publique par défaut (Atelier).
  387.  
  388.       La boîte de saisie vous permet de définir le nom de l'écran publique
  389.       qui sera ouvert.
  390.  
  391.  
  392.     - Type d'affichage : Cette liste vous permet de choisir le mode utilisé.
  393.  
  394.     Ce bouton entraîne la mise à jour des champs Largeur et Hauteur.
  395.  
  396.  
  397.     - Overscan    : Défini la surdimension standard de votre écran.
  398.  
  399.     Ce bouton entraîne la mise à jour des champs Largeur et Hauteur.
  400.  
  401.  
  402.     - Largeur        : Vous permet de définir la largeur
  403.                   exacte de votre écran.
  404.  
  405.     - Hauteur        : De la même façon pour la hateur.
  406.  
  407.     - Palette        : Grâce à la case à cocher, vous pouvez
  408.                   choisir la palette par défaut (Atelier),
  409.                   ou une palette personnalisée, que vous
  410.                   définissez dans la fenêtres des 'Options Palette'.
  411.  
  412.     - Déplacement    : Bascule l'option de défilement automatique
  413.     Automatique           lorsque qu'il est plus grand que la taille
  414.                   affichable.
  415.  
  416.  
  417.     La liste du champs Type d'affichage dépend de votre configuration ainsi
  418.     que de son installation logiciel.
  419.  
  420.     La largeur est la hauteur de l'écran peuvent varier du minimum défini
  421.     par l'état des champs Type d'affichage et Surdimension,
  422.     jusqu'a 16387.
  423.  
  424.  
  425.  
  426.     Fenêtres de la Palette
  427.     ======================
  428.  
  429. De gauche à droite et de haut en bas, vous trouvez les champs suivants :
  430.  
  431.     - Pinceaux       : Permet de définir la couleur de tous les
  432.                      pinceaux d'intuition.
  433.  
  434.     Ce champ prend toute la partie gauche de la fenêtre, de haut en bas.
  435.  
  436.     - Table des couleurs  : Permet de choisir la couleur à régler
  437.                 avec les champs Rouge|Vert|Bleu.
  438.  
  439.     - Rouge           : Ces champs régles la couleur en
  440.       Vert             cours, ils peuvent varier de
  441.       Bleu             0 à 255 (Mode TrueColor).
  442.  
  443.  
  444. La palette de couleur est défini en 24bit, que vous utilisiez un
  445. système inférieur ou supérieur à 3.0. Ceci permet une compatibilité
  446. des projets peut importe sur quel type de machine vous le chargez.
  447.  
  448.  
  449.     Utilisation du Menu
  450.     ===================
  451.  
  452. L'utilisation du menu est des plus classique.
  453.  
  454. On peut noter toutefois, qu'avec le système 3.0 et plus uniquement,
  455. le même menu se retrouve dans toutes les fenêtres.
  456.  
  457. La commande LendMenu du 3.0 est utilisée, mais ceci gêne le programme
  458. Magic Menu, les menus attaché prennent l'ancien look.
  459.  
  460.     Déscription des menus:
  461.     'Projet'
  462.     'Objets'
  463.     'Executable'
  464.     'Préférences'
  465.  
  466.  
  467.     Menu Projet
  468.     ===========
  469.  
  470. Dans ce menu, vous trouvez les fonctions suivantes :
  471.  
  472.     - Nouveau :     Crée un nouveau projet.
  473.  
  474.     - Ouvrir :        Ouvre un projet existant.
  475.  
  476.     - Sauver :        Sauve le projet en cours, lance la commande suivante
  477.             lorsque le projet n'a pas de nom.
  478.  
  479.     - Sauver sous : Affiche une requête de fichier permettant de
  480.             définir le nom du projet, et de le sauver.
  481.  
  482.     - Iconifier :   Commande non disponible pour l'instant (Plantage).
  483.  
  484.     - A propos... : Ouvre un requester contenant des informations sur
  485.             l'interface.
  486.  
  487.     - Aide... :     Avec la bibliothèque amigaguide, ouvre ce document, et
  488.             affiche la partie concerné par la fenêtre d'appel.
  489.  
  490.     - Quitter :     Quitte l'interface.
  491.  
  492.  
  493.  
  494.     Menu Objets
  495.     ===========
  496.  
  497.     - Edition :      Lance l'editeur des preferences avec, comme
  498.              paramètre, le nom du fichier sélectionné dans la
  499.              fenêtre principale.
  500.  
  501.     - Fichiers inclus :  Affiche la liste des fichiers inclus dans celui
  502.              sélectionné. Permet de les éditer par la suite.
  503.  
  504.     - Commentaires     Edition des commentaires attaché à un fichier.
  505.  
  506.     - Editer :     Edit ou crée un commentaire.
  507.  
  508.     - Supprimer :     Supprime le commentaire du fichier sélectionné.
  509.  
  510.     - Ajoutter :     Ajoutte un nouveau fichier à la liste actuelle.
  511.              Un requester permet de choisir ce fichier.
  512.  
  513.     - Supprimer :     Supprime le fichier sélectionné de la liste.
  514.  
  515.     - Editer externe :     Edit un fichier externe à la liste.
  516.              Choix du fichier avec une requête de fichier.
  517.  
  518.     - Ouvrir Autodocs :  Ouvre un fichier AutoDocs de commodore.
  519.              Nécessite la bibliothèque AmigaGuide et le choix
  520.              d'un repertoire d'autodocs dans les préférences.
  521.  
  522.  
  523.     Menu Executable
  524.     ===============
  525.  
  526.     - Créer Objet Final :     Génére complétement le projet.
  527.                  Dans le cas d'un executable, compile et edite les liens.
  528.                  Dans le cas d'une bibliothèque, compile et crée le fichier .lib.
  529.  
  530.     - Compiler :         Compile les fichiers de la liste.
  531.  
  532.     - Tour recompiler :      Recompile tout les fichiers.
  533.  
  534.     - Lancer :             Lancement de l'executable.
  535.  
  536.     - Sous CLI :         Lance l'exec. à partir du CLI.
  537.  
  538.     - Ligne de paramètres :  Définit les paramètres de lancement.
  539.  
  540.     - Information :         Affiche des informations concernant le projet.
  541.  
  542.  
  543.  
  544.     Menu Préférences
  545.     ================
  546.  
  547.     - Préférences Générales :    Affiche les {" options générales " Link "WIN_MainOpt"}.
  548.  
  549.     - Compilateur :        Définit les options du {" compilateur " Link "WIN_Compile"}.
  550.  
  551.     - Editeur de liens :    Définit les options de l'{" éditeur de liens " Link "WIN_Link"}.
  552.  
  553.     - Répertoires :        Définit les chemins d'accés des différents {" répertoires " Link "WIN_Dir"}.
  554.  
  555.     - Editeur :         Définit l'éditeur par défaut.
  556.  
  557.     - Ecran :            Définit les {" options d'affichage " Link "WIN_SCREEN"} de l'écran.
  558.  
  559.     - Fermer Atelier :        Ferme l'écran de l'atelier.
  560.  
  561.     - Ouvrir Atelier :        Ouvre l'écran de l'atelier.
  562.  
  563.     - Sauver les préférences :    Sauve les préférences actuelles dans les
  564.                 préférences par défaut.
  565.  
  566.  
  567.     Bugs connus
  568.     ===========
  569.  
  570. - Il est impossible de spécifié des chemins d'accés des objets (.o) comportant des espaces.
  571.     Ceci est dû à un bug de DICE, pas de l'interface!
  572.  
  573. - L'iconification plante le système à coups sure ! ?
  574.     Si vous désirez corriger ce bug, prenez le fichier main.c et cherchez
  575.     la ligne ProjectIcon
  576.  
  577.  
  578.  
  579.     Remerciements
  580.     =============
  581.  
  582. Pour les tests des version beta : Olivier Bompuis (France).
  583.  
  584. Pour sont générateur d'interface : Jan van den Baard (Allemagne).
  585.  
  586.  
  587.     Contacter l'auteur
  588.     ==================
  589.  
  590. N'hesitez pas à me contacté pour toutes question, je me ferais une
  591. joie d'y répondre. Les commentaires (bon ou mauvais) sont encore
  592. plus apprecié.
  593.  
  594. Vous pouvez me contacter par courier :
  595.  
  596.     M Cedric Counotte
  597.     53 Rue Brillat Savarin
  598.     75013 PARIS - FRANCE
  599.  
  600. où par courier électronique :
  601.  
  602.     Fidonet : 2:320/106.0
  603.  
  604.  
  605.